home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / readso.z / readso
Encoding:
Text File  |  1998-10-20  |  6.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrreeeeaaaaddddssssoooo((((3333GGGG))))                                                          rrrreeeeaaaaddddssssoooo((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrreeeeaaaaddddssssoooo - sets the source for pixels that various routines read
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee rrrreeeeaaaaddddssssoooo((((ssssrrrrcccc))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 ssssrrrrcccc
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _s_r_c   expects a symbolic constant that identifies the pixel source that
  17.            is to be used:
  18.  
  19.            SSSSRRRRCCCCAAAAUUUUTTTT selects the front color buffer when the current framebuffer,
  20.            as specified by ddddrrrraaaawwwwmmmmoooo, is in single buffer mode. It selects the
  21.            back color buffer when the current framebuffer is in double buffer
  22.            mode.  This is the default.
  23.  
  24.            SSSSRRRRCCCCFFFFRRRROOOO selects the front color buffer of the current framebuffer,
  25.            as specified by ddddrrrraaaawwwwmmmmoooo.  This source is valid for both single
  26.            buffer and double buffer operation.
  27.  
  28.            SSSSRRRRCCCCBBBBAAAACCCC selects the back color buffer of the current framebuffer, as
  29.            specified by ddddrrrraaaawwwwmmmmoooo.  This source is valid only while the current
  30.            framebuffer is in double buffer mode.
  31.  
  32.            SSSSRRRRCCCCZZZZBBBBUUUU selects the z-buffer of the current framebuffer.  Because
  33.            only the normal framebuffer has a z-buffer, this source is
  34.            currently valid only while draw mode is NNNNOOOORRRRMMMMAAAALLLL.
  35.  
  36.            SSSSRRRRCCCCFFFFRRRRAAAA selects the Live Video Digitizer as the pixel source,
  37.            regardless of the current draw mode.  This source is valid only on
  38.            IRIS-4D GTX and VGX models with the Live Video Digitizer option
  39.            board.  IRIS-4D GTX models support this source only during rrrreeeeccccttttccccoooo,
  40.            not rrrreeeeccccttttrrrreeee or llllrrrreeeeccccttttrrrr.
  41.  
  42.            SSSSRRRRCCCCOOOOVVVVEEEE selects the overlay planes, and is valid only while draw
  43.            mode is NNNNOOOORRRRMMMMAAAALLLL.  This source is valid only on the Personal Iris.
  44.  
  45.            SSSSRRRRCCCCUUUUNNNNDDDD selects the underlay planes, and is valid only while draw
  46.            mode is NNNNOOOORRRRMMMMAAAALLLL.  This source is valid only on the Personal Iris.
  47.  
  48.            SSSSRRRRCCCCPPPPUUUUPPPP selects the pop-up planes, and is valid only while draw mode
  49.            is NNNNOOOORRRRMMMMAAAALLLL.  This source is valid only on the Personal Iris.
  50.  
  51.            selects the ilbuffers previously allocated with ilbuffer.  This
  52.            source is valid only on the RealityEngine systems running 5.0.1 or
  53.            later.
  54.  
  55. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  56.      rrrreeeeaaaaddddssssoooo specifies the pixel source buffer that rrrreeeeccccttttccccoooo, rrrreeeeaaaaddddppppiiii, rrrreeeeaaaaddddRRRRGGGG,
  57.      rrrreeeeccccttttrrrreeee, and llllrrrreeeeccccttttrrrr  use. A separate read source is maintained for each of
  58.      the GL framebuffers:  normal, pop-up, overlay, and underlay.  Calls to
  59.      rrrreeeeaaaaddddssssoooo change the read source of the currently active framebuffer, as
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrreeeeaaaaddddssssoooo((((3333GGGG))))                                                          rrrreeeeaaaaddddssssoooo((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      specified by ddddrrrraaaawwwwmmmmoooo.  By default the read source for each framebuffer is
  75.      SSSSRRRRCCCCAAAAUUUUTTTT.
  76.  
  77.      Because read sources, with the exception of some implemented only on the
  78.      Personal Iris, always specify a source within the current framebuffer, it
  79.      is not possible to copy pixels from one framebuffer to another.  Such a
  80.      copy must be implemented by first reading pixels out of the source
  81.      framebuffer, then changing the draw mode to the destination framebuffer,
  82.      and writing the pixels.
  83.  
  84. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  85.      lrectr, readpi, readRG, rectco
  86.  
  87. NNNNOOOOTTTTEEEESSSS
  88.      This subroutine is available only in immediate mode.
  89.  
  90.      On the IRIS-4D B or G models, SSSSRRRRCCCC____ZZZZBBBBUUUUFFFFFFFFEEEERRRR is not available.
  91.  
  92.      Read sources SSSSRRRRCCCCOOOOVVVVEEEE, SSSSRRRRCCCCUUUUNNNNDDDD, and SSSSRRRRCCCCPPPPUUUUPPPP operate only on the Personal
  93.      Iris.
  94.  
  95. BBBBUUUUGGGGSSSS
  96.      On the IRIS-4D GT and GTX models, and on all Personal IRIS, XS, XS24, XZ,
  97.      Elan and Extreme systems, a single variable is shared between the four
  98.      framebuffers.
  99.  
  100.      On the Personal Iris, the source for pixel reads does not change when
  101.      changing framebuffers (via ddddrrrraaaawwwwmmmmoooo) unless the current selected read
  102.      source is SSSSRRRRCCCCAAAAUUUUTTTT (the default).
  103.  
  104.      On some IRIS-4D GT and GTX models, while copying rectangles with blending
  105.      active, rrrreeeeaaaaddddssssoooo also specifies the bank from which _d_e_s_t_i_n_a_t_i_o_n color and
  106.      alpha are read (overriding the bbbblllleeeennnnddddffff setting).
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.